Cream of the Crop 22/Cream of the Crop 22.iso/os2/djdemo.zip/diskjock.hlp

OS/2 Help File | 1996-08-12 | 299KB | 1,453 lines

ΓòÉΓòÉΓòÉ 1. DiskJockey Overview ΓòÉΓòÉΓòÉ

The DiskJockey is Clear & Simple's answer to file management for OS/2, it helps
you easily navigate through the maze of drives and directories and play your
disks. While OS/2's object oriented folder/icon approach to file management is
great for many operations, it often leaves much to be desired in terms of
navigating speed and simplicity.

 DiskJockey is designed to be quick and easy to use.  It offers multithreaded
facilities for file operations such as delete, copy, move, view and rename.  It
also includes unique facilities for quickly playing multimedia files including
a built-in JukeBox for queueing up both audio and midi files.

The DJ really shines when used for ZIP and UNZIP operations.  Using Info-Zip's
archiving (zipping) utilities and the DJ Zip Container - just drag and drop
files onto the zipper to add them to an existing archive.  Viewing a zipped
file is also a snap, just double-click and you get a view of what's inside -
further clicking on the file list lets you view, play and extract individual
files in the zipped file without unzipping!

 You can also easily change file attributes, quick format diskettes with a
single click and create directories. Additional features include: Drive
Clean-Up to remove unwanted duplicate files, file search and file cataloging.
All functions are easily accessible in the convenient and straight forward
Control Panel by mouse and/or keyboard hot keys.

The DiskJockey Control Panel:

Important Note!

This help book assumes that you have basic knowledge of the workings of OS/2
(Like how to use a keyboard and mouse). Be sure to remember that your mouse has
two buttons! OS/2 uses the right mouse button (aka mouse button two)
extensively as does the DJ. Take the time to learn the workings of the second
mouse button and you will find the DJ (and OS/2) to be more powerful, flexible
and useful.


ΓòÉΓòÉΓòÉ 2. Navigating with the DiskJockey ΓòÉΓòÉΓòÉ

The DiskJockey uses a model of file navigating based on text-lists, whereas the
OS/2 WorkPlace Shell uses an icon-object model.  DJ adopted this method because
on most systems the text-list model is faster when locating and displaying
directories, filenames and statistics.  In addition, many people find the
text-list model easier to use.  Copy and move operations are simply performed
by selecting the directory or file(s) to be copied, then pressing the copy or
move button.  A "Where-to" list will appear prompting you to choose the "TO"
directory.  Popup menus and shortcut keys augment the buttons for added
convenience, depending on where the mouse pointer is located, or when your
hands are on the keyboard.

We recognize that the WPS model also has its advantages, especially when
performing drag and drop operations.  For this reason, the DJ was designed to
work with the WPS, supporting both list-based copy/move/delete and drag and
drop copy/move/delete.

OPEN a WPS FOLDER

The DJ provides a function for opening WPS drive and directory folders with a
simple double-click on the list item within the DJ.  Double-click on the C:
drive in its list of drives - and the drive folder will open.  Similarly, a
double-click on a directory name will open a WPS directory folder.

DRAG and DROP

Within the DJ files may be dragged and dropped onto the Jukebox or Zip
container.  Also, files may be dragged from the Search and/or the Catalog
windows to the Clear & Simple Logo on the main screen to copy or move files to
the "current" directory.  Files can not be dropped onto the directory list or
drives list (but you can open a drive or directory folder and drag and drop to it).

When dragging to the DJ (from the WPS) you may drop onto the Clear & Simple
Logo to move/copy to the "current directory" - that directory is the name
immediately below the logo.  You may also drag multimedia files from a folder
dropping them onto the Jukebox, likewise directories and/or files may be
dragged from a folder and dropped onto the Zip container.

When dragging from the DJ you may drag file(s) to a WPS drive or directory
folder or to another active copy of the DJ!

When you first start DiskJockey it will open highlighting the drive and
directory which was selected the last time you used it.  Likewise when
switching drives, the directory last selected on that drive will be highlighted.

For help with selecting drives, directories or files click on one of the topics below:

Selecting Drives

Selecting Directories

Selecting Files


ΓòÉΓòÉΓòÉ 2.1. Selecting Drives ΓòÉΓòÉΓòÉ

Changing Current Drive

To switch drives simply single click on the drive letter in the drive bar along
the left side of the window:

 Or select from the pull down drive list on top:

You can also tab to the window and select the drive from the keyboard.

Select a diskette drive (A: or B:) to display the free space on the diskette
currently in that diskette drive (displayed in the status line).

Double-click on a drive letter to open a WPS default view of that drive.


ΓòÉΓòÉΓòÉ 2.2. Selecting Directories ΓòÉΓòÉΓòÉ

Changing Current Directory

To view files in a new directory just single click on the directory name in the
Directory tree window:

Clicking on a directory with subdirectories will show the directory expansion
symbol. Click on it to show the subdirectories below.

Double-click on a directory name to open a WPS default view of that directory
(folder).


ΓòÉΓòÉΓòÉ 2.3. Selecting Files ΓòÉΓòÉΓòÉ

Selecting files

In order to perform a file operation you must first select a file or group of files.

First, select the directory you wish to choose from.

To Select a single file, position the mouse pointer over the file (in the file
window), and click on mouse button 1.

To select multiple files, hold mouse button 1 down over the first file and
swipe across the files you want.

You can also select or deselect individual files by holding the <Ctrl> key and
clicking on the file with mouse button 1.

File Window

Double-clicking on a file or list of files will invoke the DJ's viewer, giving
you a quick view of the contents of the file(s).  Once files are selected all
file operations are easily performed - just press a button!

After files are selected they may also be dragged and dropped to the
Jukebox/Zip container or to WPS folders.

Selecting a file that has an HPFS longname in its extended attributes will
display that file's longname in the status line.

For other selection options see Marking and UnMarking Files.


ΓòÉΓòÉΓòÉ 2.4. Searching for files ΓòÉΓòÉΓòÉ

Searching For Files

Use the search function to quickly locate, view and catalog files.

Press the  button on the Control Panel and you will be presented with a search
dialog box:

First you must define the parameters of your search:

o   First, select the drives to be searched.

o   Then add a file specification (filespec). Use wildcards (*,?).

o   To further narrow your search use these optional search parameters:

    -   Text String - Useful for finding a specific text item inside a file.

    -   Creation Date - Tell the search to include files created before and/or
        after a certain date.

    -   Size - Include files larger than a given size, in multiples of 1000.

    -   Exclude files with the following extensions.  The standard three
        character file extension should be entered - there is no need for the
        period - multiple extensions should be separated by semicolons.  e.g. exe;dll;sys;inf

Select the drives, specify path, filespec and/or text string to search for and
press the  button.  Results of the search are placed in the results window.

Launch programs or view files from the window by double clicking on the file's name.

The  button will halt the search.

The  button will reset the form for a new search.

To Catalog files press the  button. -See File Catalogs for further instructions.

Check the "Reduce Priority" box to limit a search's use of the CPU. Useful for
searching large volumes while multitasking. This option will slow down the
search time.

The buttons View, Delete, Copy, Move and Edit are the same as their
counterparts on the main panel. See their explanations for instructions.

Press  to close the search session.

Also See: Search Panel Elements


ΓòÉΓòÉΓòÉ 2.5. File Catalogs ΓòÉΓòÉΓòÉ

Catalog

DJ's catalog facility gives you an easy way to group files with common
characteristics.  For example, you might want a catalog of all of the .MID
files across all of the drives in your system.  Using the catalog panel you can
quickly access this entire group.

Cataloging files

To catalog files, first perform a search based on how you would like to
organize the files. After the search is completed press the  button.

This will bring up the catalog window:

Fill in a catalog description, if desired.

Give the catalog a name and press the  button to create the catalog. If the DJ
is installed on an HPFS drive you can give the catalogs long, descriptive
names. On FAT drives you are restricted to the 8.3 naming convention

View catalogued items by selecting files to be viewed and pressing the  button
or by double clicking on them. See Viewing Files for more information.

Other Panel Elements:

o   Size - Shows total size of selected files.

o   Time Stamp/Total selected - Shows date of file's creation if only one file
    is selected. If multiple files are selected, shows # selected.

o   Button Bar - Buttons used to perform actions in Catalog contents window.
    See Search function help for more details.

Catalog Maintenance

You can perform several of the DJ's file operations and search or delete
catalogs from within the Catalog Maintenance window.

First open the "Catalog Maintenance and Viewing" window by pressing the  button.

Select a catalog to view from the catalog list.

Use the buttons along the bottom of the window to:

o   Update. Press the  button to refresh catalog based on original search
    parameters.

o   The buttons View, Delete, Copy, Move and Edit are the same as their
    counterparts on the main panel. See their explanations for instructions.

o   Find files in selected catalogs by pressing  the  button. This brings up a
    dialog box.

o   To remove catalogs from the list, select the catalogs you would like to
    delete and press the  button.

o   Press  to return to the main DJ window.

o   Drag file(s) directly from the file list to the DJ main window:  Drop onto
    the Clear & simple logo will perform a copy/move operation to the current
    directory.  Drop onto the DJ logo to play in the Jukebox.  Drop onto the
    Zip container to add the file to an existing zip file.  Drop onto a WPS
    folder to move/copy to that folder.

Also See: Catalog Panel Elements


ΓòÉΓòÉΓòÉ 3. Performing file operations ΓòÉΓòÉΓòÉ

DiskJockey performs standard file operations on single or multiple selected
files. Click on the operation below to view detailed instructions.

o   Copy

o   Delete

o   Move

o   Rename

o   Zip

o   UnZip

o   Change File Attributes

o   View

o   Mark and UnMark


ΓòÉΓòÉΓòÉ 3.1. Copy ΓòÉΓòÉΓòÉ

Copying Files

To copy file(s) first, select the files you wish to copy.

Then click the  button.

Or, click the right mouse button in the file window to bring up the pop-up menu:

Choose Copy.

Or, Use the keyboard shortcut <F2>

You will be presented with a Where To? copy dialog: from which you can select a
destination for the copy operation.

Press the  button to start Copying.

For situations where you are copying HPFS "long named" files to FAT volumes,
the DJ may automatically rename the files. This can cause conflicts. See the
section in this helpfile called "Special note on HPFS to FAT operations" for
more details.


ΓòÉΓòÉΓòÉ 3.2. Delete ΓòÉΓòÉΓòÉ

Deleting Files

To delete file(s) first, select the files you wish to delete.

Then click the  button.

Or, click the right mouse button in the file window to bring up the pop-up
menu:

Or, Use the keyboard shortcut <F3> or the Delete button on your keyboard.

If you do not have "Confirm?" checked, the selected files will be deleted
without warning.

Press the  button to start Deleting.

Deleting Directories

The DJ lets you delete entire directory structures.  This includes all of the
subdirectories within a directory and all of the files in the directory and its subdirectories.

First, select the directory you wish to delete.

Then click on the delete button. or use the popup menu, or keyboard shortcut
keys, like deleting a file.

Directory deleting will always be "confirmed" even if you have Confirmation
checked "No".

Delete Method

This preference option is difficult to explain.  The two choices use different
OS/2 mechanisms for deleting directories.  Destroy uses the OS/2 DestroyObject
facility.  This is the faster method of deleting an entire directory structure.
However, it will not delete files that have special WPS non-deleteable
attributes set.  When encountering those hard-to-delete directories, choose the
DJdelete option.  This option causes a more deliberate method of deletion.
Starting at the end of the directory structure each file's attributes are
changed to assure deletion, likewise the directory attributes are reset before
deletion.  This will take longer, but it does get the job done!


ΓòÉΓòÉΓòÉ 3.3. Move ΓòÉΓòÉΓòÉ

Moving Files

To move file(s) first, select the files you wish to move.

Then click the  button.

Or, click the right mouse button in the file window to bring up the pop-up
menu:

You will be presented with a "Where To?" move dialog, from which you can select
a destination for the move operation.

Press the  button to start Moving.

For situations where you are moving HPFS "long named" files to FAT volumes, the
DJ may automatically rename the files. This can cause conflicts. See the
section in this helpfile called "Special note on HPFS to FAT operations" for
more details.


ΓòÉΓòÉΓòÉ 3.4. Rename ΓòÉΓòÉΓòÉ

Renaming Files

To rename a file, first select the file you wish to rename.

Then click the  button.

Or, use the keyboard shortcut <ALT+r>

This will activate the entry field below the file window. Enter the file's new
name here:

Then press the  button or <enter> to complete the operation.


ΓòÉΓòÉΓòÉ 3.5. Zipping ΓòÉΓòÉΓòÉ

Zipping Files

What is Zipping?

The Zip function is an excellent way to compress files. File compression takes
a file or group of files and reduces them into a single file, often called a
zipfile. This is useful for archiving or backing up files, fitting large or
numerous files on a diskette, or reducing the online time necessary to send
files over the internet.

Use UnZip to decompress Zipped files.

How To Zip

To Zip file(s) or a directory, first select the files or directory you wish to Zip.

Then, click the  button.

Or, click the right mouse button in the file window to bring up the pop-up
menu:

Select "Zip" from the menu.

Or, Use the keyboard shortcut <F4>

If you have a directory selected, the entire directory will be compressed into
a file named "directory.zip"

If you have selected a file or a group of files they will be compressed into a
file with the name of the first file of the group but with the extension ".zip"
( i.e. "firstfile.zip" ).

You will be presented with a "Where To?" Zip dialog, from which you can select
a destination for the new Zip file.

You may also change the name of this file in the "Where To?" box. You do not
have to name it with the .zip extension, however the .zip will make it easier
to identify as a zipfile.

Press the  button to start Zipping.

Easiest Zipping see : ZIP Container

Advanced Options

The DJ has made some of Zip's advanced options available.  We wanted to keep it
fairly simple.

Click on the "Advanced Options" button to open:

-j junk (don't record) directory names

Default - checked when zipping a list of files, unchecked when zipping a directory.

Checking this item, removes the directory name in the resulting zipped file.
By unchecking this box, the directory name is recorded along with the
filenames, later, when you unzip the zipped file you may choose to have the
directory structure created at the unzip location.

-m  move into zipfile (delete files)

This advanced option essentially zips the selected file(s) and then deletes
them. This is useful for those times you want to free some disk space, but
you're not sure you want to entirely discard a directory or group of files.
The default is unchecked.

-S  include system and hidden files

This advanced option allows you to include those files normally not seen by the
casual user - those files with the system and/or hidden attribute set. Since
the DJ optionally shows these system and hidden files, we included this as an
advanced option.  The default is unchecked, so you must check this item to have
files with system or hidden attributes included in the resulting zipped file -
the DJ does not assume inclusion when this option is left unchecked, even if
the file is selected - also, there is no warning.

-f  freshen: only add changed files

This advanced option is for the times when you want to update those large
zipped files with a few changed ones.

-u  update: only changed or new files

Similar to the above, also includes new files.

-q  quiet operation

The default, doesn't provide any feedback.  The DJ will notify you if there are
error conditions.  If there are, we recommend that you re-run the zip operation
with this turned off - so that additional error information can be provided.
(see the -v option below)

-v  verbose operation

This is how to turn quiet operation off.  Checking this option turns on the
DJ's Standard I/O window, to show the OS/2 messages we normally spare the user
from.  It also informs the zip operation to give details of its zipping.

-T  Test zipfile before deleting source

This should be used with the move into zipped file option explained above.
Always a good idea to use with that option.  Default unchecked, but it is
automatically checked when the -m move into zipped option is checked..

-r  include all sub-directories

The default is checked when zipping a directory - unchecked when zipping a list
of files.  Uncheck , when zipping a directory and you don't want the
sub-directory structure included in the resulting zipped file.

Compression Level

Higher number chosen will attempt to produce a greater compression - will
increase the time needed to zip.

Also See:

Zip Container

About Zip and UnZip


ΓòÉΓòÉΓòÉ 3.6. Zip Container ΓòÉΓòÉΓòÉ

 Zip Container

Drag and drop files into the zip container and they will be automatically
compressed into a zip archive! This allows for easily grouping files into an
archive.

To add files to an existing zip archive:

1.  Position the mouse pointer over any .zip file and single click on it.

    This will change the Clear & Simple logo, in the upper right corner of the
    DJ panel, into the Zip Container.

2.  Now you can select files to archive and simply drag and drop them into the
    Zip Container!

3.  Repeat step 2 for files in other directories or drives.

4.  When finished zipping just double click on the Zip Container to close it,
    the DJ logo will reappear.


ΓòÉΓòÉΓòÉ 3.7. UnZipping ΓòÉΓòÉΓòÉ

Unzipping Files

How to UnZip

Use Unzip to extract compressed files from a zipfile.

To UnZip a file, first select the file you wish to UnZip.

Then click the  button.

Or, click the right mouse button in the file window to bring up the pop-up
menu:

Or, Use the keyboard shortcut <F5>

You will be presented with a "Where To?" UnZip dialog, from which you can
select a directory for the files to be unzipped into.

Press the  button to start Unzipping.

Extracting a single file

You can extract a single file from a zipfile by selecting and double-clicking
on that file.  This will use the DJ view facility to show you the contents of
the zipped file in list form.  Select the file you want to extract and then
press the Extract button.  the file will be extracted (unzipped) to the current directory.

Advanced Options

The DJ has made some of the unzip advanced options available. There are two
options and four modifiers to be used with the options.

Press the "Advanced Options" button to open:

-f  freshen existing files, create none

When unzipping a file, the extracted files will only update those that already
exist in the to location.  Default is unchecked which will update and create
new files.

-u  update files, create if necessary

When unzipping a file the extracted files will update existing files, and
create new files. This is the DJ's default.

-n  never overwrite existing files

When unzipping a zipped file, the resulting files may not overwrite a file in
the to location (if that file exists).  Default is unchecked.

-qq suppress msgs   -v display msgs

The default, -qq, doesn't provide any feedback.  The DJ will notify you if
there are error conditions.  If there are, we recommend that you re-run the
unzip operation with the -v display msgs turned on - so that additional error
information can be provided.

-j  do NOT recreate paths

An option for those files previously zipped with the option to keep the
directory information.  Checking this option tells the DJ to ignore that
directory information and not create the directory structure.  The default of
unchecked will create directory paths if present in the zipped file.


ΓòÉΓòÉΓòÉ 3.8. Changing file attributes ΓòÉΓòÉΓòÉ

Changing File Attributes

DiskJockey allows you to easily change a file's or multiple files' attributes.

To change a file's attributes: first, select the file(s) you wish to modify.

Then click the  button.

This will present the change attributes dialog:

For each attribute  you will have three choices:

o   Make no change.

o   Turn attribute off

o   Set attribute on

Once you have made your selections press the  button to make the changes.


ΓòÉΓòÉΓòÉ 3.9. View ΓòÉΓòÉΓòÉ

Viewing Files

DiskJockey handles several file types with a quick internal viewing facility.
For unrecognized filetypes the selected file will open in it's default view or application.

To view a file:

o   Select the file(s) to view.

o   For single files just double click on the file name.

o   For multiple files press the  button.

Internally supported filetypes

DiskJockey has internal support for the following filetypes:

o   Graphics files: .bmp, .gif, .tif, .jpg

    These filetypes are quickly viewed with the DJ's internal view window.

o   Sound files: .wav, .mid, .au

    Sounds are cued for sequential play in the DJ's Jukebox.

    Use the controls much like you would those on a CD player:

     Skips forward or back through cued sounds.

     Temporarily pauses play.

     Restarts play.

     Stops play.

o   Plaintext files

    Textfiles are presented in a searchable window for quick access.

    o   Zipfiles

    Double click on a zipfile to display its contents:

    Click on a file in this view window to view or execute directly from the
    zip archive!

    Select a file and press the Extract button to have that single file
    extracted (unzipped) from the zipped file.

If you do not like the DJ's viewers you can select your own. See Configuring
Viewers and Editors for details.


ΓòÉΓòÉΓòÉ 3.10. Jukebox ΓòÉΓòÉΓòÉ

The Jukebox

Select multiple or individual audio/video files and drag and drop them onto the
Jukebox window (this is the DJ logo). The files will be sequentially cued and
play will begin automatically. Sounds and video files are played in a
background thread so that you can perform other operations at the same time.
An alternate way to play is by double-clicking on a file or group of files, or
selecting a group of files and pressing the play button or even the view button.

Use the player controls to skip forward or back, pause, stop or resume play.


ΓòÉΓòÉΓòÉ 3.11. Marking and Unmarking Files ΓòÉΓòÉΓòÉ

Marking and Unmarking Files

DiskJockey has several options for marking files.

-Press the  button

-Or, Use the keyboard shortcut <ALT+M>

A dialog box appears:

Select the options for the files you wish to mark.

o   All files will mark all the files in the file window.

o   No files will unmark any selected files in the file window.

o   Reverse marking will mark unselected files and unmark previously selected
    files (right click on the UNMARK button will also reverse mark).

o   If you choose Filespec..., enter a file specification you wish to mark (or unmark).

o   The text option will search for a given text string anywhere in the filename.

After choosing the desired action, press the  button.

To quickly select all files use the keyboard shortcut <ALT+m>

Files can also be selected or deslected directly. See Selecting Files for more information.


ΓòÉΓòÉΓòÉ 3.12. Sorting files ΓòÉΓòÉΓòÉ

Sorting Files

Three ways to sort the current file list:

1.  -Click on the  button.

    -A dialog box will appear:



    -Choose your sort criteria: filename, extension, size or date/time.

    -Select ordering of sort: ascending or descending

    -Set when you want the sort to occur: one-time, Sort this run (this
    session), permanent (all DJ sessions), No Sorting (suspend sorting now and
    in following DJ sessions).
    -Press the  button or <ENTER> to begin.

2.  -Right click in the file window to expose the pop-up menu.

    -Select desired sort options:

3.  Use the keyboard shortcuts:

    -<ALT+d> Sort by name, descending

    -<ALT+s> Sort by name, ascending

    -<ALT+x> Sort by extension, ascending

    (all are one-time sorts)


ΓòÉΓòÉΓòÉ 3.13. Quick Format ΓòÉΓòÉΓòÉ

This action will quickly format a diskette.

To format a diskette:

o   Insert the diskette to be formatted into the drive.

o   Use the right mouse button to toggle between drive A: and drive B: (if
    present.)

o   Click the  button to format the diskette.

o   If you have the Confirmation option set "On" a window will pop up to warn
    you that all information on the diskette will be lost, etc.

Keyboard Operation

o   You can also use the keyboard shortcuts:

    <ALT+a> Formats drive A:

    <ALT+b> Formats drive B:


ΓòÉΓòÉΓòÉ 3.14. Making Directories ΓòÉΓòÉΓòÉ

To create a new directory:

1.  Select the directory where you want the new directory to be created.

2.  -Click on the  button.

    -Or, use the keyboard shortcut <ALT+n>

3.  Enter the new directory name in the entry field:

    This DJ can create several levels of directories at the same time. Just
    enter the directories as a path and they will be automatically created.
    i.e.: L:\parent\new1\new2\new3\newetc

4.  Click on the  button.


ΓòÉΓòÉΓòÉ 4. Preferences ΓòÉΓòÉΓòÉ

Preference Menu

The Preference pull-down menu allows you to tailor the DJ's fonts and actions
to your tastes.

Clicking "Preferences" on the menu bar presents the menu:

The viewing item lets you select between the DJ's internal viewer or an objects
system default viewer.

Clicking the Set Font  option gives you a list of font types and sizes to
choose from:

Click on default to return the DJ's fonts to their original state.

This pull-down menu will change the font for all windows. To change the font
for individual windows click the right mouse button in the window you wish to
change and use the font option of the pop-up menu.

You can also change fonts by using the Keyboard hot keys:

o   <ALT+f> Resets to default font.

o   <ALT+2-0> Sets font size 2 through 10

o   <CTRL+1-8> Sets font size 11 through 18

Auto Dir Expand allows you to toggle the automatic expansion of subdirectory
trees when the parent directory is selected. The default is On.

Beep lets you turn off the beep sound when an operation completes. Defaults to On.

Auto Dir Return toggles on/off the feature that returns you to the working
directory when a file operation completes. The default setting is On.

Confirmation toggles the confirm option on/off. With this option on a
confirmation message will occur when deleting files or formatting a diskette.

The Editor option presents a dialog box which allows you to specify the default
editors and viewers used by the DJ. See Configuring Viewers and Editors for
more information.

Colors allows you to save a custom color configuration or reset the colors to
their default. To change the DJ's colors, use the system's color palette to
drag and drop the color on the area of the DJ you would like to change. Hold
down the <Ctrl> key to change the foreground (text) color.

Show Hidden Files When checked off this option screens out hidden, system and
read-only files from the file window. These are usually key system files which
should not be eliminated or moved. If you are unsure about this option it is
probably best to leave it set to "off."

Delete Method For most file and directory deletions the standard destroy method
will do the job. For files with the un-deleteable extended attribute a
different method "DJ Delete" will reset the un-deleteable EA and delete the
file. This can be time consuming during normal operation, so we made it an
option. If you are having difficulty deleting certain files, give the DJ Delete
option a try - but be careful - undeleteable files are often that way for good reason.


ΓòÉΓòÉΓòÉ 5. About Info-Zip ΓòÉΓòÉΓòÉ

The DiskJockey uses Info-ZIP's compression utilities for it's Zip and UnZip
functions. Info-ZIP is a widely used and distributed FREEWARE package.  No
charge has been added to the DiskJockey's price for the distribution of this
freeware package.  It is included as a convenience for users of the DiskJockey.

 The latest versions of Zip and UnZip (at the time of this publication) are
included with the DiskJockey. For more information see the official
accompanying documentation. Info-ZIP's software (Zip, UnZip and related
utilities) is free and can be obtained as source code or executables from
various anonymous-ftp sites, including ftp.uu.net:/pub/archiving/zip/*.


ΓòÉΓòÉΓòÉ 6. Hot Keys ΓòÉΓòÉΓòÉ

Keyboard Shortcuts

The DiskJockey makes extensive use of keyboard shortcuts, often called Hot Keys.

Below are the hot keys and a brief description of their functions.

<F1> Help. Opens context sensitive help dialog.

<F2> Copy

<F3> Delete

<F4> Zip

<F5> UnZip

<ALT+a> Format A:

<ALT+b> Format B:

<ALT+B> Turn Beep Option on

<CTRL+B> Turn Beep Option off

<ALT+c> Turn Confirmation option on

<CTRL+c>Turn Confirmation option off

<ALT+d> Sort by name, descending

<ALT+e> Edit

<ALT+f> Reset to default font sizes

<ALT+l> Filter

<ALT+m> Mark all

<ALT+M> Opens Mark dialog

<ALT+n> Make new directory

<ALT+o> Open default file view

<ALT+r> Rename

<ALT+s> Sort by name, ascending

<ALT+x> Sort by extension, ascending

<ALT+2-0> Set font sizes 2 through 10

<CTRL+1-8> Set font sizes 11 through 18


ΓòÉΓòÉΓòÉ 7. Editing Files ΓòÉΓòÉΓòÉ

Editing Files

To edit a text file:

1.  Select the file(s) you would like to edit.

2.  Press the  button or, choose the edit option from the Right Mouse Button
    pop-up menu:

3.  Your editor of choice will open with the selected file loaded.

    See the Configuring Viewers and Editors section for information on
    selecting an editor.


ΓòÉΓòÉΓòÉ 8. Main Panel Controls Description ΓòÉΓòÉΓòÉ

Main Panel

Double Click anywhere on the panel below for more info about that feature.


ΓòÉΓòÉΓòÉ 8.1. Drop Box ΓòÉΓòÉΓòÉ

The Clear & Simple logo in the upper left corner of the main window is used to
receive a drag and drop action. i.e.: Dragging an object from an open folder to
the Drop Box will copy/move that object to the DJ's current directory.


ΓòÉΓòÉΓòÉ 8.2. Current Dir Window ΓòÉΓòÉΓòÉ

Shows fully qualified pathname of currently selected directory.

 Also see: Selecting Directories


ΓòÉΓòÉΓòÉ 8.3. Sub button ΓòÉΓòÉΓòÉ

Press to include all subdirectories below current directory in calculation of
space used.  Warning: this could take a long time to calculate on a large
directory structure.  It is done in a background thread - but changing the DJ's
current directory will cause the results to be lost.


ΓòÉΓòÉΓòÉ 8.4. Total Space Window ΓòÉΓòÉΓòÉ

Shows total space used by all files in active directory. Includes all files in
all subdirectories in calculation when  button is pressed.


ΓòÉΓòÉΓòÉ 8.5. Number of files window ΓòÉΓòÉΓòÉ

This shows the number of files contained in the current directory.


ΓòÉΓòÉΓòÉ 8.6. Date & Time ΓòÉΓòÉΓòÉ

Today's date and time of day.


ΓòÉΓòÉΓòÉ 8.7. Jukebox/Zip container window ΓòÉΓòÉΓòÉ

This field is used for two purposes. Drag files to this window to cue for
jukebox or add to active zipfile. Shows DJ logo when Jukebox; zipper logo when
Zip Container.

  Also See: Jukebox

         Zip Container


ΓòÉΓòÉΓòÉ 8.8. Jukebox/Zip container Name window ΓòÉΓòÉΓòÉ

Shows name of sound being played by Jukebox or active zipfile in Zip Container.


ΓòÉΓòÉΓòÉ 8.9. Jukebox Controls ΓòÉΓòÉΓòÉ

Buttons used for controlling play of sound files.

  Also See: Jukebox


ΓòÉΓòÉΓòÉ 8.10. Jukebox Volume ΓòÉΓòÉΓòÉ

Adjusts volume of Jukebox's currently playing sound.

Also See: Jukebox


ΓòÉΓòÉΓòÉ 8.11. Drive Pulldown Menu ΓòÉΓòÉΓòÉ

Shows detailed info on all drives. Includes Drive Letter, File System Type,
Total Drive Space, Free Space, Percentage of Total space currently available
and Drive Label. Select a drive from the list to make it the current drive.

  Also See: Selecting Drives


ΓòÉΓòÉΓòÉ 8.12. Selected files Space ΓòÉΓòÉΓòÉ

Shows total drive space used by currently selected files.


ΓòÉΓòÉΓòÉ 8.13. Number of selected files window ΓòÉΓòÉΓòÉ

Shows number of files currently selected in file window.


ΓòÉΓòÉΓòÉ 8.14. FIlter Window ΓòÉΓòÉΓòÉ

Displays user defined filter for files displayed in File window.

  Also See: File Filters


ΓòÉΓòÉΓòÉ 8.15. File Window ΓòÉΓòÉΓòÉ

Shows files in selected directory according to specified file filter.

  Also See: Selecting Files


ΓòÉΓòÉΓòÉ 8.16. File Details Window ΓòÉΓòÉΓòÉ

Presents detailed information about each file. Includes file's Size, Date and
Time of creation,  and Attributes.

  Also See:  Selecting Files

          Changing file Attributes


ΓòÉΓòÉΓòÉ 8.17. File Operation Count ΓòÉΓòÉΓòÉ

Shows number of files remaining for current Copy, Move or Delete operation.


ΓòÉΓòÉΓòÉ 8.18. Status Line ΓòÉΓòÉΓòÉ

The status line has several uses:

- It presents error and status messages pertaining to current file operation.

- Enter name during rename operation or file filter specs.

- Displays HPFS longnames when a selected file has a longname in its extended attributes.

- Free space on a diskette is placed in the status line when a diskette drive
is selected and there is a diskette present.


ΓòÉΓòÉΓòÉ 8.19. Clean-Up button ΓòÉΓòÉΓòÉ

Press Clean-Up to find and review Duplicate files in system.

  Also See: Drive Clean-Up


ΓòÉΓòÉΓòÉ 8.20. Information Line ΓòÉΓòÉΓòÉ

Shows information about the field that the mouse pointer is positioned over.


ΓòÉΓòÉΓòÉ 8.21. Drive Window ΓòÉΓòÉΓòÉ

Shows all drives available in system. Active Drive is highlighted.

  Also See: Selecting Drives


ΓòÉΓòÉΓòÉ 9. Search Panel Elements ΓòÉΓòÉΓòÉ

Search Panel Elements

Click an area of the search panel to view detailed information about each element:


ΓòÉΓòÉΓòÉ 9.1. Filespec ΓòÉΓòÉΓòÉ

Enter a filename search string. Wildcard characters (*,?) may be used. i.e. To
find all files with the extensions ".htm" and ".html" enter "*.htm*".  This is
a required field for the search operation.


ΓòÉΓòÉΓòÉ 9.2. Exclude Files ΓòÉΓòÉΓòÉ

Enter file extensions to exclude from the search. i.e. If your search filespec
is *.* but you would like to exclude all files with the extensions ".txt" and
".zip" then enter "txt;zip" here. (Extensions should be separated with semicolons.)


ΓòÉΓòÉΓòÉ 9.3. Text String ΓòÉΓòÉΓòÉ

Enter a text string to search for within the files matching the given filespec.


ΓòÉΓòÉΓòÉ 9.4. Creation Date ΓòÉΓòÉΓòÉ

Enter dates to exclude from search. Use the format mm/dd/yy.


ΓòÉΓòÉΓòÉ 9.5. Size Field ΓòÉΓòÉΓòÉ

Use the size field to specify a lower size limit for a search in multiples of
1000. i.e. To find all files larger than 10,000 bytes, enter 10.


ΓòÉΓòÉΓòÉ 9.6. Search Results Window ΓòÉΓòÉΓòÉ

Shows fully qualified path and name of all files matching specified search
criteria. Use this window to select files for file operations View, Delete,
Copy, Move or Edit.


ΓòÉΓòÉΓòÉ 9.7. Button Bar ΓòÉΓòÉΓòÉ

Buttons used to perform actions in "Results Window". See Search function help
for more details.


ΓòÉΓòÉΓòÉ 10. Catalog Panel Elements ΓòÉΓòÉΓòÉ

Catalog

DJ's catalog facility gives you an easy way to group files with common
attributes.  For example, you might want a catalog of all of the .BMP files
across all of the drives in your system.  Using the catalog panel you can
quickly access this entire group.

Catalog Panel Elements

o   Catalog Name - Enter a name for this catalog here.

o   Catalog Description - Enter a description for the current catalog.

o   Catalog Contents Window - Similar to the Search Results Window. Shows fully
    qualified path and name of all files in catalog.

o   Size - Shows total size of selected files.

o   Time Stamp/Total selected - Shows date of file's creation if only one file
    is selected. If multiple files are selected, shows # selected.

o   Button Bar - Buttons used to perform actions in Catalog contents window.
    See Search function help for more details.

o   Drag file(s) directly from the file list to the DJ main window:  Drop onto
    the Clear & simple logo will perform a copy/move operation to the current
    directory.  Drop onto the DJ logo to play in the Jukebox.  Drop onto the
    Zip container to add the file to an existing zip file.  Drop onto a WPS
    folder to move/copy to that folder.


ΓòÉΓòÉΓòÉ 11. Clean-Up Window ΓòÉΓòÉΓòÉ

Clean-Up Window

o   Duplicate Search Parameters - These are similar to the fields found in the
    "Search Window"

o   Filespec include - Filespec of files to be included in the duplicate search.

o   Filespec exclude - Filespec of files to be excluded from the duplicate search.

o   Date exclusion - Excludes files before and after specified date from search

o   Size exclusion - Excludes files based on size. Set 3-State checkbox to
    exclude files larger than or less than a given filesize (in multiples of
    1000 bytes) or set for "No size limits" to include files of any size.

o   Result Window - Shows duplicate files found.

o   Button Bar - Buttons used to perform actions in "Results Window".

     Also See:

     View

     Delete

     Copy

     Move

     Edit


ΓòÉΓòÉΓòÉ 12. Where To? Window Elements ΓòÉΓòÉΓòÉ

Where To? Window Elements

o   Path Field - Shows currently selected path. Can be directly edited to
    create a new directory.

o   Drive Window - Shows all drive available in system. Active Drive is highlighted.

o   Directory Tree Window - Shows currently selected drive's directory structure.

o   Create New Directory - Check this box to allow the DiskJockey to create a
    directory entered in the "Path Field"


ΓòÉΓòÉΓòÉ 13. Drive Clean-Up ΓòÉΓòÉΓòÉ

Drive Clean-Up

After using your system for a while you may start running out of drive space.
Oftentimes you can free up space by eliminating files that are duplicated in
multiple directories on your system.

Use the Drive Clean-Up function to search your drives and find redundant files.
It's a great way to eliminate files that might be wasting valuable drive space!

To perform a drive Clean-Up start by pressing the  button. This will open the
Clean-Up window:



Enter your search parameters. These are similar to the fields in the "Search Window"

Press the  button.

The DJ will perform the search and report back the results. Here's some
duplicates on my "C" drive:

Duplicates are listed together and separated from others by a blank space.

Most likely you will want to move or delete the duplicates.

CAUTION:
 As you can see in the example above, some files are duplicated in the system
archives. These files are used to recreate your desktop if it becomes
corrupted. They are valuable backups which should not be removed. Be careful
when removing duplicates!

 From this window you may also perform the following file operations:

Launch programs or view files from the window by double clicking on the file's name.

To Catalog files press the  button. -See File Catalogs for further instructions.

The buttons View, Delete, Copy, Move and Edit are the same as their
counterparts on the main panel. See their explanations for instructions.

Drag file(s) directly from the file list to the DJ main window:  Drop onto the
Clear & simple logo will perform a copy/move operation to the current
directory.  Drop onto the DJ logo to play in the Jukebox.  Drop onto the Zip
container to add the file to an existing zip file.  Drop onto a WPS folder to
move/copy to that folder.

The  button will halt the search.

The  button will reset the search form for a new search.

Press  to close the Clean-Up session.


ΓòÉΓòÉΓòÉ 14. Special note on HPFS to FAT operations ΓòÉΓòÉΓòÉ

The DJ gives you the option to control copying files to/from HPFS volumes
to/from FAT volumes.  As you know, HPFS supports filenames up to 255 characters
long - the name may even contain spaces!  Whereas FAT only supports the 8.3
character filenaming convention.

HPFS longnames

OS/2 provides a facility within its extended attributes to retain the long
filename when copying to FAT volumes.  Many file managers don't take advantage
of this facility - even the OS/2 copy command misses this feature.  The DJ
gives you the option to turn this On or Off.  This option is found in the
preferences menu.  The setting is retained for subsequent DJ sessions.

Why turn it Off?  Speed is the answer, especially when copying to diskette.

Leaving it On, provides you the advantage of having the longname associated
with a FAT file so that when it is copied it back to an HPFS volume - the
longname is used.  Also when selecting filenames on a FAT volume - the longname
(if present) will display in the status area.

HPFS longnames Off

In situations where a "long named" HPFS file is copied or moved to a FAT
volume, up to the first 8 characters before the first period, and the first
three characters after the last period are used to rename the file. Spaces are
changed to underscores.

 i.e.: "averylong.file.name" would become "averylon.nam".

   "this.file.name" would become "this.nam"

   "name with.spaces.in it" becomes "name_wit.in_"

This works very well for most copy operations. However, in the interest of
maintaining the efficiency of copy and move operations we found it necessary to
make a concession concerning this renaming.

A problem occurs using this algorithm: if you have files where the first eight
characters before the first period and the first three after the last period
are the same but the middle characters are different, a conflict may occur. If
they are copied at the same time, they will overwrite one another. This is best
illustrated by an example:

If

 "longname.file1.problem" becomes "longname.pro"

and:

 "longname.file2.problem" becomes "longname.pro"

As you can see, both files are given the same name.

This is not a problem if they are copied one at a time, because the DJ will
prompt you to rename or copy over them. But if you batch copy them the DJ will
not catch this anomaly and will copy the second file over the first.
Therefore, do not batch copy files which use this naming convention for it will
cause them to overwrite each other.

We found that further error checking at this level significantly slowed down
all copy operations. In order to optimize performance under most situations, we
decided to let this be.


ΓòÉΓòÉΓòÉ 15. Configuring Viewers and Editors ΓòÉΓòÉΓòÉ

Configuring Viewers

The DiskJockey is capable of natively viewing many standard filetypes. You may,
however, find situations where you prefer to use your own viewer for this
purpose. The DJ can be easily configured to use third party viewers. To do so,
choose the editors/viewers option from the Preferences pull down menu. This
will open the editor configuration window.

Enter the filetype extension in the field on the left. Then specify the
viewer's fully qualified pathname in the viewer field. Either directly enter it
or locate it with the DJ and drag and drop the viewer from the DJ's control
panel to the entry field.

Press the add button to add the filetype and viewer to the list of
associations. Add as many viewers as you would like. When you are finished
press the save button to save your entries and exit the configuration window.

To remove a viewer configuration:

Open the editors/viewers configuration menu, select the viewer you would like
removed and press the delete button.

To change viewer configurations:

Open the viewer configuration menu, select the viewer you would like to change
and press the edit button. This will place the extension and viewer name in the
entry fields where they can be easily changed as above.  Placing * in the
extension field will cause the corresponding viewer to become the viewer for
all files, (if you have more than one viewer you want the DJ to use, place the
* at the end of the list).

Configuring Editors

Specify the text editor to be opened when the Edit action is selected. The DJ
is set up initially to open OS/2's system editor. Choose the
Preferences-->Editors/Viewers from the pull down menu to change the default
editor. You are given three choices: System Editor, Enhanced Editor or User editor.

To specify a third party editor select "User Editor" and enter the editor's
path and name.


ΓòÉΓòÉΓòÉ 16. File Filters ΓòÉΓòÉΓòÉ

Limit the display of files in the "File Window" to those matching a specific
name format by entering a File Filter.

By default this is set to "*.*" which includes all files.

To change the file filter press the  button. This will activate the filter
entry field:

Enter a filter in the field and press the "Set Filter" button. The wildcard
characters "*" and "?" can be used.

i.e. To only show files with the extension "txt" enter "*.txt" in the filter field.

Toggle back to the default "*.*" setting by right clicking on the  button.


ΓòÉΓòÉΓòÉ 17. Refresh Button ΓòÉΓòÉΓòÉ

Use the  button directly above the Drive Window to refresh the drive, directory
and file windows. This is particularly useful when changes have been made in
the workplace shell which the DiskJockey is not aware